home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / english / elfboot2 / elfboot.doc < prev    next >
Text File  |  1995-11-25  |  69KB  |  1,321 lines
  1.      
  2.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  3.  
  4.      
  5.      I. INTRODUCTION
  6.  
  7.  
  8.           Thanks for trying ELF-BOOT!, a powerful new startup utility for
  9.      the ATARI ST, from Elfin Magic Software. While there are many startup
  10.      utilities for the ST which go in your auto folder, this is the only one
  11.      that provides a familiar GEM-like interface, complete with mouse 
  12.      pointer, dialog boxes, one click functions, and even a file select 
  13.      window! If you decide not to install ELF-BOOT, because you think your 
  14.      current startup utility is probably just as good, you're really missing
  15.      out! Try it...  I guarantee you'll like it! Finally, I must mention 
  16.      that the user interface is so instinctive, that you may be tempted to
  17.      lay the docs aside. READ THESE DOCS! Otherwise, you'll never get 
  18.      optimum use out of the system.
  19.  
  20.  
  21.                    ***** Important Note on DEMO version! *****
  22.  
  23.           If the your main program file is called "ELFBOOTD.PRG", this is a
  24.      demonstration copy of the program, but don't worry...  It contains
  25.      every single feature that the "registered" version contains.  However,
  26.      a commercial message about shareware has been added to the code.  Which
  27.      brings us to an important point. This program IS a shareware offering.
  28.      In actual use you will find it to be a very complete and thoroughly
  29.      planned application, with features you would expect to find in a
  30.      commercial offering. If you agree and find ELF-BOOT to be a valuable
  31.      asset to your system, you'll want to register your ownership by sending
  32.      $15 to:
  33.  
  34.                       Randy Constan c/o Elfin Magic Software
  35.                         23 Brook Place, E. Islip, NY 11730
  36.  
  37.  
  38.      In return, You'll receive a copy of the registered version in the mail,
  39.      along with printed documentation (if you request), full support for any
  40.      problems you encounter, and access to updates and revisions at a
  41.      substantial discount. In fact, it is possible that by the time you
  42.      register, more features will have been added! The demo version contains
  43.      a 40 second commercial message, which will appear only 1 out of 4 times
  44.      the program is used.  It is a simple reminder that a lot of time and
  45.      effort went into this product, and shareware authors gotta eat too!
  46.  
  47.  
  48.                            ******** DISCLAIMER ********
  49.  
  50.      Although I (and several 'beta' testers) have beaten the program to
  51.      death forcing every conceivable error, I must hereby state that I nor
  52.      the Elfin Magic company assume any responsibility for lost time or data
  53.      resulting from the use or misuse of ELF-BOOT. The user assumes
  54.      responsibility for backing up his system to prevent such disasters. I
  55.      can only affirm that to the best of my knowledge, the program will
  56.      perform as stated in the docs, and at the time of distribution
  57.      contained no 'viruses' of any kind.
  58.  
  59.  
  60.                THANKS IN ADVANCE FOR SUPPORTING SHAREWARE AUTHORS!
  61.  
  62.  
  63.      
  64.                                      Page 1
  65.  
  66.      
  67.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  68.  
  69.           
  70.      FILES:
  71.  
  72.           Before proceeding, be sure you have all the following files in
  73.      your ELFBOOT package:
  74.  
  75.           ELFBOOT.PRG    Main program (or ELFBOOTD.PRG for demo version) .
  76.           ELFHELP.PRG    Utility to assist in preparing special batch files.
  77.           STARTGEM.PR    A public domain program run utility.
  78.           RAMDISK.PRG    ATARI's public domain reset proof ramdisk.
  79.           RDSET.TTP      A freeware utility from Elfin Magic to set the
  80.                          default drive and size of the ramdisk.
  81.           DESKTOP.L      Some default desktop.inf files for each resolution
  82.           DESKTOP.M
  83.           DESKTOP.H
  84.           ELFBOOT.DOC    The file you're reading.
  85.           README.DOC     May contain last minute changes. Check it out!
  86.  
  87.      ELF-BOOT: What it does...
  88.  
  89.      ELF-BOOT normally resides in the AUTO folder of your hard disk. It can
  90.      also be re-run from the desktop at any time. For maximum utility, it
  91.      also requires that the file "STARTGEM.PR" (notice the  missing "G") be
  92.      placed in the AUTO folder, after ELF-BOOT has been added. When it runs,
  93.      ELF-BOOT will allow you to:
  94.  
  95.           1) Load, and modify up to 50 desktop.inf files. Desktop colors,
  96.              printer configuration, keyboard repeat, delay, bell silence and
  97.              key click can all be controlled, as well the option to confirm
  98.              copies & deletes, and turn disk write verify on or off.
  99.  
  100.           2) Automatically select a default desktop file based on the
  101.              current monitor (color or mono), so that your system can boot
  102.              up properly with no manual intervention.
  103.  
  104.           3) Install an option called 'AUTOCOLOR' which keeps your selected
  105.              desktop colors in place when the system completes it's startup.
  106.              This feature also prevents other applications from changing
  107.              your colors, unless you want them to.
  108.  
  109.           4) Completely eliminate the need for the ATARI control panel desk
  110.              accessory, freeing up 2 valuable 'slots' for other accessories.
  111.  
  112.           5) Enable or disable programs in your AUTO folder.
  113.  
  114.           6) Easily change the order in which programs in your AUTO folder
  115.              will run.
  116.  
  117.           7) Activate any one of up to 50 ASSIGN.SYS files for use with
  118.              GDOS, or prevent any from becoming active.
  119.  
  120.           8) Enable and disable Desk accessories.
  121.  
  122.           9) Automatically transfer any number of files from up to 50 user
  123.              defined lists, from any drive (and path) to an active ramdisk.
  124.  
  125.          10) Cause your ST to run any of 50 preset programs without having
  126.              to double click them from the desktop. As of the time of this 
  127.              writing though, THIS OPTION IS UN-USABLE WITH TOS 1.4. 
  128.              Hopefully, this will soon change.
  129.  
  130.                                      page 2
  131.      
  132.  
  133.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  134.  
  135.      
  136.          11) Create and or activate up to 50 macro files, which can perform
  137.              all the above functions, in one mouse click!
  138.  
  139.          12) View and/or modify the system time and date, for those without
  140.              a real time clock.
  141.  
  142.           Best of all, even though the program runs in an AUTO folder, It
  143.      provides an active mouse, dialog and alert boxes, multiple fonts,
  144.      button click functions, and even displays a file select window with
  145.      scrolling arrows! No, I have not discovered some hidden feature in the
  146.      ATARI to make this possible. Rather, I wrote my own 'mini-GEM' in 100%
  147.      assembly code.  Because of the familiar environment, you'll find that
  148.      in most cases, just guessing what to do will give you the expected
  149.      result. But again.... read _ALL_ the documentation!
  150.  
  151.  
  152.                **********************************************
  153.  
  154.      II. PREPARATION:
  155.  
  156.  
  157.      1) DESKTOP.INF FILES
  158.  
  159.           ELF-BOOT can be used with or without desktop.inf files. But unless
  160.      you're a rare breed that likes ATARI's default lo res. desktop, these
  161.      files are important. The first thing you should do is prepare at least
  162.      one "default" desktop file for each of the 3 normal ATARI resolutions.
  163.      Since many users don't have both color and mono monitors, a sample
  164.      DESKTOP file for each res. is provided on the ELF-BOOT disk, so you can
  165.       accomplish this step even if you have only one monitor.
  166.  
  167.           If you have a color monitor, prepare your own desktop.inf file in
  168.      medium resolution, with the desired colors, window/icon placement, and
  169.      installed applications you desire. If you do not currently use a
  170.      ramdisk, setup an icon for one now.  To do this, just select any disk
  171.      icon, and select "INSTALL DISK" from the desktop menu.  Then, specify
  172.      an unused drive identifier from D: thru  P: at the prompt.  Finally,
  173.      place the new icon in a convenient location on the desktop.
  174.  
  175.           Set up your colors using ATARI's CONTROL.ACC for now.  See your
  176.      ATARI manual for details.  When you've saved the file using the 'SAVE
  177.      DESKTOP' option, rename the file "DESKTOP.M".  Then, close all your
  178.      windows and switch to LO res with the set preferences option from the
  179.      desktop.  When you're satisfied with your LO res setup, again save the
  180.      file, and RENAME it to DESKTOP.L.  If you have a monochrome monitor,
  181.      follow the same procedure, this time renaming the file "DESKTOP.H".
  182.      Finally, switch to the resolution you use most often, set up your
  183.      screen, and do one final DESKTOP save, without renaming the file.  If
  184.      you have only one monitor, copy the default(s) for the files you can't
  185.      make yourself, from the ELF-BOOT files provided.
  186.  
  187.           When ELF-BOOT starts up, it looks for a file called DESKTOP.INF.
  188.      If it finds one, it will analyze it to make sure it's usable for the
  189.      current monitor type. If not, it will look for the default "DESKTOP.M"
  190.      or "DESKTOP.H" depending on the monitor you're using. Providing the
  191.      program finds a usable desktop file, it will allow the user a chance to
  192.      exit the program immediately, and will automatically copy the file to a
  193.      new DESKTOP.INF file if necessary, when the program exits.
  194.  
  195.  
  196.                                      page 3
  197.  
  198.           
  199.           ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  200.  
  201.      
  202.           You may also create up to 48 more (total 50) desktop files, for
  203.      all your applications. It's quite handy to have the desktop appear with
  204.      the proper windows open and colors set in accordance with the work you
  205.      intend to do. Again though, for a bare minimum, you should have at
  206.      least 1 file on hand file for each resolution you use, and it's a good
  207.      idea to use the extender of the filename to indicate the resolution it
  208.      is intended for. Beyond this, there are only three simple rules:
  209.  
  210.        1) Each file must begin with  'DESK' (eg: DESKWP.HI or DESKDRAW.L)
  211.  
  212.        2) All files must be in the root directory of your boot drive.
  213.  
  214.        3) Any non DESKTOP.INF file whose name starts with "DESK" must be
  215.         removed from the root directory.
  216.  
  217.  
  218.      2. AUTO PROGRAMS:
  219.  
  220.           ELF-BOOT provides full control over the files in your AUTO folder.
  221.      This includes both re-ordering the files, and enable/disable capability.
  222.      It accomplishes this by COPYING and DELETING files,and RENAMING file
  223.      extenders from .PRG to .PR and vis-versa. So, to maximize the power of
  224.      this feature, you should copy every conceivable AUTO program you ever
  225.      use into your auto folder, renaming ones you normally don't use to have
  226.      a .PR extender. This way, the program can find them all, and give you 
  227.      full control. If you're an experienced ATARI user, you know that the 
  228.      order of execution of your AUTO folder programs is important. For this
  229.      and other reasons, this is a very good time to rebuild your auto folder
  230.      from scratch. The ST will then both execute the files in the order in which
  231.      you store them and, contain no 'hidden' deleted entries.
  232.  
  233.           To accomplish this, start by backing up your AUTO folder
  234.      completely, and then empty the contents of the AUTO folder, by deleting
  235.      all its' files. Then, one by one, begin placing files back into the
  236.      AUTO folder.  Remember that AUTO programs are executed in the order you
  237.      place them in the folder, not the order they appear on the screen!
  238.  
  239.           When you rebuild your empty AUTO folder, I'd suggest the following
  240.      order:
  241.  
  242.        1) Your hard disk boot program if required,
  243.  
  244.        2) The ATARI reset proof RAMDISK.PRG provided in the ELFBOOT package
  245.           (even if you sometimes use other RAMDISKS). The ramdisk is
  246.           currently setup to be drive G:, and has a 'default' size of under
  247.           64K. If drive G: is currently used by one of your hard drive
  248.           partitions, copy the file anyway (so it will be in the proper
  249.           place in the auto folder), but rename the file RAMDISK.PR for now.
  250.           Later, we'll see how to easily change the default configuration of
  251.           the ramdisk, with the RDSET.TTP utility provided.
  252.  
  253.      By the way, if you normally use another ramdisk product that can
  254.      function in the AUTO folder, you can obviously use yours instead. But
  255.      if you normally use a ramdisk that can't run as an AUTO folder, place
  256.      the ATARI ramdisk in the AUTO folder anyway! You'll see why later....
  257.      trust me!
  258.  
  259.  
  260.      
  261.                                     page 4
  262.  
  263.      
  264.      
  265.           ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  266.  
  267.      
  268.        3) PINHEAD, if you have it (v.1.8 or higher only), by Charles F.
  269.           Johnson. Actually, I've gotten away with placing this utility
  270.           _BEFORE_ the ramdisk, but save such experimentation for later.
  271.           Also, rename the program to simply PINHEAD.PRG.
  272.  
  273.        4) your real-time clock program if you have one,
  274.  
  275.        5) FOLDERXXX.PRG (I HOPE you use have this!)
  276.  
  277.        6) Any other programs that you use ALL the time,
  278.  
  279.        7) this program (ELF-BOOT). If you're installing the demo version,
  280.           rename it to "ELFBOOT.PRG".
  281.  
  282.        8) all other AUTO programs that you sometimes need active, and
  283.           sometimes don't (GDOS for example).
  284.  
  285.        9) the file "STARTGEM.PR" provided in the ELF-BOOT package.
  286.  
  287.           The reason for the suggested renaming by the way, is this: ELFBOOT
  288.      is capable of storing entire system file setups in macros, and these
  289.      macros save actual filenames as part of their data. By getting into the
  290.      habit of using 'generic' names for your programs, you can avoid having
  291.      to 'rebuild' these macros every time you change program revisions. For
  292.      example, the ELFBOOTD.PRG file was renamed ELFBOOT.PRG in the above
  293.      setup. In this way, when you install your registered copy, you can
  294.      simply copy it over and keep the same name. Again, if this sounds
  295.      confusing, don't worry about it too much. It will all become clearer as
  296.      you become familiar with the way ELFBOOT handles files.
  297.  
  298.           Remember to rename all the programs you normally don't use so they
  299.      have a .PR extender. Of course, if you're an experienced user, your
  300.      AUTO files are probably already ordered fairly well. In that case, just
  301.      add the ramdisk, ELFBOOT.PRG and STARTGEM.PR (in that order) to
  302.      your ramdisk. ELFBOOT will allow you to re-order these files anyway,
  303.      it's just easier if only a few files are out of place. Finally, I'll
  304.      say this one more time: be sure your auto folder is backed up!
  305.  
  306.      3. ASSIGN.SYS files
  307.  
  308.      Create a folder in the root directory (of your boot drive) called
  309.      "ASSIGN". in this folder, you may place up to 50 assign.sys files, with
  310.      any names that seem logical to you. (eg: WORDPROC.BW or EASYDRAW.COL)
  311.      if you already have an ASSIGN.SYS file in your root directory, you can
  312.      keep it there as long as a copy (with whatever name you choose) exists
  313.      in the ASSIGN folder. If you don't use ASSIGN files, just create the
  314.      folder for now, with no entries.
  315.  
  316.  
  317.      4. DESK ACCESSORY FILES
  318.  
  319.      Copy all the desk accessory files you own (that are known to be bug
  320.      free!) into the root directory of your boot drive. Even the ones you
  321.      seldom use, as long as there's not more than 50 of them. Disable all
  322.      but 6 of them (or less) by renaming them so their extender is ".AC"
  323.      instead of "ACC". For now, disable the ATARI CONTROL.ACC as well. Once
  324.      you've used it to create your default DESKTOP files, and begin using
  325.      ELF-BOOT, You may never need it again, and this frees up 2 slots!!!
  326.  
  327.  
  328.                                      page 5
  329.  
  330.           
  331.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  332.      
  333.           
  334.      5. RAMDISK TRANSFER
  335.  
  336.           ELF-BOOT can (very!) quickly transfer a group of files to a
  337.      ramdisk! This is very handy if you have an ongoing project in which you
  338.      normally spend time moving the same files into your ramdisk every time
  339.      you boot.  However, in order for ELF-BOOT to accomplish this, the
  340.      RAMDISK program must have been previously run. This is why I recommend
  341.      keeping ATARI's reset proof RAMDISK in your AUTO folder. It is easily
  342.      sized or even disabled at boot time with a single keystroke.  However,
  343.      If you use a DESK.ACC type ramdisk, you can still make great use of
  344.      this feature, since ELF-BOOT can be re-run from the desktop at any
  345.      time.
  346.  
  347.           For now, just Create a folder in your root directory, and call it
  348.      "TRANSFER".  Later, we'll see how the supplied support program
  349.      "ELFHELP.PRG" may be used to quickly create up to 50 'batch' files for
  350.      use with this feature.
  351.  
  352.  
  353.      6. STARTGEM
  354.  
  355.           If you're using any version of TOS but 1.4, create a folder in
  356.      your root directory called STARTGEM. The public domain program
  357.      STARTGEM.PRG (renamed .PR in your ELFBOOT package) is capable of
  358.      automatically running any program on bootup, just by placing the
  359.      programs' full path and filename in a text file called STARTGEM.INF.
  360.      In the STARTGEM folder you just created, you can store up to 50 such
  361.      text files, with names of your choosing. ELFBOOT will automatically
  362.      take care of copying the one you select, and enabling/disabling 
  363.      STARTGEM.PRG as needed. (This is why it's current filename ends in
  364.      ".PR" instead of ".PRG"). Later, we'll see how the supplied ELFHELP.PRG
  365.      can assist you in accurately creating these text files, without errors
  366.      or hassle.
  367.  
  368.      7. MACROS!
  369.  
  370.           Create one more folder in your root directory called "ELFMACRO".
  371.      No need to fill it with anything, ELFBOOT handles all the processing
  372.      here. Later, we'll see how almost everything ELFBOOT does for you can
  373.      be saved in a macro file, for a totally customized setup every time you
  374.      use your ST!
  375.  
  376.  
  377.      III. PROGRAM USE:
  378.  
  379.           OK... now comes the fun part! For the first time, run ELF-BOOT
  380.      from the desktop, even though it's in the auto folder. This way, if
  381.      there's  anything wrong with the program file, or if there's any
  382.      incompatibility with some other program that's resident in memory
  383.      (TSRs), you'll find out with a harmless crash to the desktop.
  384.  
  385.           When you run the program, the startup screen will appear, followed
  386.      by an alert box. If the DESKTOP.INF file was present (or alternately,
  387.      if either DESKTOP.H or DESKTOP.M  is all that's available), the dialog
  388.      box will offer 3 choices. You have 10 seconds to choose, or option 2
  389.      (EXIT with AUTOCOLOR) will be selected by default. For now, click the
  390.      mouse on choice 3: USE ELF-BOOT!. If no DESKTOP file was found, you
  391.      will see a different dialog box reminding you to select one before
  392.      exiting. In this case, click on EXIT (upper right corner of screen),
  393.  
  394.                                      page 6
  395.  
  396.      
  397.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  398.  
  399.      followed by clicking on EXIT WITHOUT AUTOCOLOR in the next dialog box.
  400.      Then, retrace your steps and see where you went wrong. Remember, in the
  401.      demo version, 1 out of 4 exits will display, a 40 second commercial.
  402.  
  403.           When you select the 'USE' option, you'll see the entire ELF-BOOT
  404.      work screen.  To the left, there are displays for the Time, Date,
  405.      printer configuration, keyboard configuration, Disk parameters (Confirm
  406.      copies, deletes, and disk verify), buttons for keyboard click and bell,
  407.      and in the lower left, color control. The parameters displayed are all
  408.      taken from the 'current' desktop file (or from the system itself if no
  409.      desktop file exists). Here is a brief synopsis of how these work:
  410.  
  411.      Printer: Just like the ATARI control panel. Set each parameter by
  412.               clicking the appropriate box. These parameters may be changed
  413.               at any time, whether the program is run from an AUTO folder at
  414.               boot time, or later from the desktop.
  415.  
  416.      Disk:    For the confirm deletes/copies buttons to be toggled, a
  417.               desktop file must exist. But even so, these parameters can
  418.               only be changed in the system when the program is run from the
  419.               AUTO folder at boot time. Write verify for disk operations
  420.               however can be turned off or on at any time. But note that
  421.               this item will always default to active (verify on) since I
  422.               believe it shouldn't be disabled without user intervention.
  423.  
  424.      Time/Date: These displays update automatically every 2 seconds.  To
  425.                 change the time or date, just click on the appropriate box
  426.                 and type your new entry. The program parses date and time
  427.                 strings fairly intelligently, and all the following are
  428.                 legal entries:
  429.  
  430.                 Time: 03:22:10 AM, 3:23, 3:24P, 03:23 PM
  431.                 DATE: 05/01/91, 5/01/91, 5/1/91
  432.  
  433.      Press escape if desired to clear the string and start again, just as in
  434.      a normal GEM dialog box. Other than that, the backspace is your only
  435.      active editing key. Hit RETURN, ENTER, or click the mouse to complete
  436.      your entry. The new date or time will be installed in the system and
  437.      displayed. If the program can't make sense out of your entry, the
  438.      original time or date will re-appear.
  439.  
  440.      Keyboard: The keyboard click and delay rate may be varied to within the
  441.                same limits that the ATARI CONTROL.ACC allows. Simply click
  442.                on the up or down arrows for the desired parameter. Feel free
  443.                to press any key and hold it to check the results of your
  444.                change. To the right, the keyclick and console bell sound may
  445.                be enabled or disabled. Keep them both enabled for now
  446.                (highlighted), since they are used to aid the unfamiliar
  447.                user of ELF-BOOT. For example, anytime you click the mouse in
  448.                an inactive area, or when certain errors occur that the 
  449.                program wants to draw attention to, the console bell will
  450.                ring in addition to any status messages present.
  451.  
  452.      Color:    This is a big feature if your using a color monitor! Click on
  453.                any color box from 0 to F (representing 1 - 16 in GEM order),
  454.                and you'll see the color change, both in the screen display,
  455.                and in the color box to the right. Note that even though the
  456.                program is running in medium res. (on a color monitor), all
  457.                16 colors can be  viewed in this special color box!. This
  458.                will allow you to alter all the colors of a LO res
  459.      
  460.                                      page 7
  461.      
  462.      
  463.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  464.  
  465.                
  466.                desktop.inf file without even being in lo res! To alter any
  467.                color, select the color number (0-F), then click the left or
  468.                right arrows in the RED, GREEN, or BLUE box. The numerical
  469.                color value, as well as the color itself will show up in the
  470.                color box. If you're in monochrome, colors 0 and 1 will only
  471.                allow two settings (BLACK on WHITE, or WHITE on Black). The
  472.                other colors may be edited normally.
  473.  
  474.      A very important feature of the color control is this: You can select
  475.      any resolution desktop file (we'll see how to do this later), and the
  476.      program will make visual sense out of the colors! That is, from a color
  477.      monitor, You can load in a HI or LO res desktop, and edit the colors
  478.      perfectly, While the screen display accurately shows what the colors
  479.      will look like in the resolution of the chosen desktop. You'll have to
  480.      experiment with this later to see what I mean. Also, should you
  481.      accidently edit the colors in such a way that the screen becomes
  482.      difficult to read, clicking the color box itself will temporarily
  483.      install a preset color palette. This will not effect the color box or
  484.      the color data itself. Any additional editing, or clicking the color
  485.      box again will toggle the actual desk colors back to the screen. The
  486.      more you need to use this, the more you'll like it!
  487.  
  488.  
  489.      Status Box:
  490.  
  491.           In the status box on the lower right, the default message shows
  492.           the current free ram, as well as the type of desktop file
  493.           currently in memory. Actually, the 'Free RAM' message indicates
  494.           the amount of memory that ELFBOOT has available for copying files,
  495.           etc, rather than the total ram available. For most disk
  496.           operations, this status box will also display information showing
  497.           the various stages of the selected process, or will provide
  498.           instructions as to your next logical action. If during a disk
  499.           operation, you hear the console bell and all activity seems to
  500.           stop, check the status box to see how to proceed.
  501.  
  502.      FILE OPERATIONS:
  503.  
  504.           In the center of the screen there are 8 boxes with associated file
  505.      select operations. Each is designed to accomplish it's goal in as few
  506.      mouse clicks as possible. All items make use of the file select window
  507.      to the right, in one way or another. When a file function box is
  508.      clicked, the associated directory will be displayed in the window. If
  509.      more than 12 items are in the directory, the right sidebar will become
  510.      shaded, as an indicator. In this case, you can use the UP and DOWN
  511.      arrows at the  upper right and lower left of the window, to scroll the
  512.      display. If no items are present, the status box will reflect this, and
  513.      the menu box you selected will clear. Also, regarding the UP and DOWN
  514.      arrows, holding the mouse button down will allow continuous scrolling.
  515.      When the window can be scrolled no further, the console bell will ring.
  516.      The status box will also reflect the number of items found. To select a
  517.      file from a directory, just click on it (double click has no meaning in
  518.      ELF-BOOT).  The Top window bar will also display the name of the
  519.      selected directory!
  520.  
  521.           Note that ELFBOOT will automatically choose the 'MACRO SELECT' box
  522.      and display the 'ELFMACRO' directory, IF there are macros present.
  523.      Since no macros have been created yet, the system will instead default
  524.      to the 'SELECT DESKTOP.INF' option. This should be the case now, and a
  525.  
  526.                                      page 8
  527.           
  528.  
  529.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  530.  
  531.      
  532.      directory of your desktop files should already be present in the
  533.      window. We'll skip this option for now though, and explore all the
  534.      menu boxes from top to bottom.
  535.  
  536.  
  537.      1. Auto Program Enable:
  538.  
  539.           Clicking this item causes all entries in your AUTO folder with
  540.      either a .PR or .PRG extender to be shown. To rename (enable) a .PR
  541.      file, just click on it. To disable a .PRG file, again just click on it.
  542.      It's that simple! Each time you click on a file, the status box will
  543.      show the result, and the directory will be refreshed. Incidentally, you
  544.      never have to worry about the enabled or disabled status of
  545.      STARTGEM.PRx. ELF-BOOT will take care of that automatically as
  546.      necessary.
  547.  
  548.      NOTE:   By default, the files in the window are sorted by length of
  549.              extender. That is, .PRG files will show up on top of .PR files.
  550.              However, the order of execution within each group is correctly
  551.              displayed. Sometimes though, it is annoying while enabling or
  552.              disabling files to see files 'jumping' to and from the .PRG
  553.              group. So, you may turn off this sort function at any time by
  554.              clicking the 'FILE SORT' box at the lower right corner of the
  555.              screen. After altering this box, clicking the selected menu box
  556.              again will produce a 'raw' directory listing. This may or may
  557.              not be to your liking, you decide.
  558.  
  559.  
  560.      2. Auto program sequence:
  561.  
  562.           Clicking here displays only the items in your AUTO folder with a
  563.      .PRG extender. The directory shows accurately the order in which the
  564.      programs run during bootup. (this is true regardless of the SORT
  565.      option, since all files here have the same extender length). To change
  566.      this sequence, click on one file, then another. ELF-BOOT will attempt
  567.      to copy both programs to memory, delete them both from the disk, and
  568.      rewrite them in reverse order. If you click the same file twice, the
  569.      operation will abort, and you'll have to start over (this is also a
  570.      simple way to get out if you change your mind!). By the way, it doesn't
  571.      matter which file you select first. As you select files, the status box
  572.      will show the result of each step. This operation goes surprisingly
  573.      fast from a hard disk, even with large files (MUCH faster than doing
  574.      the same thing from the desktop!). After each pair of files has been
  575.      swapped, a fresh directory will be displayed to verify the new sequence.
  576.      By repeating the process with different files, you can very quickly
  577.      re-sequence your entire AUTO folder.
  578.  
  579.      NOTE: This is the only operation in ELF-BOOT that deletes primary
  580.            files! It is very heavily error trapped, and hopefully you'll
  581.            never see half the dialog boxes and instructions that come up if
  582.            problems arise.  It is highly unlikely, but if the program
  583.            encounters a situation where files have been deleted and can't be
  584.            re-written, it will warn you and abort the operation. This is why
  585.            it is important to backup your entire AUTO folder, as suggested
  586.            earlier.
  587.  
  588.  
  589.  
  590.  
  591.      
  592.                                      page 9
  593.  
  594.           
  595.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  596.      
  597.      3. ASSIGN SYS File select:
  598.  
  599.           Clicking here will cause the program to see if there is an
  600.      ASSIGN.SYS file already in the root directory. If so, it will ask you
  601.      with an alert box if you want to delete it. If you answer no, the
  602.      operation will abort. Answering yes however will delete the file, and
  603.      display a directory of the ASSIGN folder you set up earlier. If you
  604.      want, click on one of the displayed files (if you have them), and it
  605.      will be copied to the root directory with the name 'ASSIGN.SYS'. If you
  606.      don't want an active ASSIGN.SYS file, simply don't select any files
  607.      after the delete occurs.
  608.  
  609.  
  610.      4. DESKTOP.INF file select:
  611.  
  612.           This option will display all files in the root directory that
  613.      start with "DESK...". Clicking any one of them will cause it to load
  614.      into memory. Before acting on the data though, the program analyzes the
  615.      file to see if it was intended for the current monitor. If not, it
  616.      warns you of the discrepancy, and asks if you want to cancel your
  617.      selection, or install it anyway. You can install ANY desktop into the
  618.      program, regardless of resolution, (it's just a warning). Also, any
  619.      desktop changes (obviously including your selecting a new one) causes
  620.      ELF-BOOT to automatically save the current file as "DESKTOP.INF" when
  621.      you exit the program, unless the resolution of that file is wrong. In
  622.      that case, no such automatic save will take place. This can be
  623.      overridden, as we'll see next. For now though, especially if you're
  624.      using a color monitor, experiment by loading files for each resolution.
  625.      You'll see that the system handles colors form any desktop file in a
  626.      logical and friendly way.
  627.  
  628.           When the selected desktop file is loaded, all the data within that
  629.      file (Excluding GEM window and icon data) is immediately installed into
  630.      your system, and displayed in the PRINTER, DISK, KEYBOARD, and COLOR
  631.      displays.  Any modifications you make to these boxes will instantly
  632.      change the file data, as well as the ST itself. Again, these changes
  633.      are not really permanent, since ELF-BOOT normally saves this file as
  634.      DESKTOP.INF (a filename that is constantly overwritten). But the
  635.      changes CAN be saved permanently, as we'll see next.
  636.  
  637.      4.1 DESKTOP.INF file save.
  638.  
  639.           It isn't included in the 8 menu functions we're discussing, since
  640.      it's a "SAVE" rather then a "SELECT" or "LOAD" function. However, it
  641.      does seem logical to discuss it here. Skip down to the bottom of the
  642.      screen, and you'll see a SAVE DESKTOP select button. Assuming a desktop
  643.      file is installed in the program (either automatically on startup, or
  644.      manually with the previous menu function), you can control whether, and
  645.      HOW it is saved by clicking here. Assuming the file is in memory,
  646.      you'll be able select:
  647.  
  648.           1- SAVE NOW
  649.           2- SAVE WHEN PROGRAM EXITS
  650.           3- CANCEL (DON'T SAVE AT ALL)
  651.  
  652.      These options are self explanatory, except that option 2 (save when
  653.      program exits) will force it to be saved as DESKTOP.INF (the default
  654.      condition). The current filename is also displayed. Option 3 prevents
  655.      saving on exit, in case you're just browsing through your desktop
  656.      files.
  657.      
  658.                                      page 10
  659.      
  660.      
  661.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  662.  
  663.      
  664.      If you choose option 1 to SAVE now however, you'll be given 3
  665.      additional choices:
  666.  
  667.           1- SAVE with current filename
  668.           2- Save as 'DESKTOP.INF'
  669.           3- Enter a new filename.
  670.  
  671.  
  672.           The current filename is of course also displayed. Picking option 1
  673.      or 2 will save the file immediately. Saving with the current filename
  674.      means that any change you made to the system parameters is permanently
  675.      saved. Again, this illustrates how ELF-BOOT eliminates the need for the
  676.      ATARI CONTROL accessory. Saving as DESKTOP.INF instead just causes the
  677.      normally automatic save on exit to occur now instead of later, and
  678.      the original file is not altered. If option 3 is selected, another
  679.      dialog box will appear, allowing you to enter a new file name. Don't
  680.      enter any drive specifiers or path names here! Just a (max 12 char.)
  681.      filename.  The save will always go to the root directory.  Entering a
  682.      blank line will abort the operation in case you change your mind. The
  683.      same text editing rules for time/date entry also apply here. Just
  684.      remember that the name you choose must start with "DESK..." if you want
  685.      it to be selectable from ELF-BOOT.
  686.  
  687.  
  688.      5. Desk Accessory enable:
  689.  
  690.           This works just like AUTO program enable/disable! Click here, and
  691.      all root directory files ending with .AC or .ACC will be displayed.
  692.      Clicking on one will either enable or disable it, and an appropriate
  693.      status message will be posted. The same rules of the FILE SORT box
  694.      discussed earlier also apply here. Also, remember that only the first 6
  695.      accessories will load into the system, and some files like CONTROL.ACC
  696.      (which you'll probably never use again) and SNAPSHOT.ACC take up 2
  697.      accessory slots! You must keep track of this yourself.
  698.  
  699.  
  700.      6. Ramdisk Transfer:
  701.  
  702.           Clicking here will display any text files you'll prepare later
  703.      with the ELFHELP.PRG program. You don't have these set up yet, but
  704.      here's how it will work when you do. Selecting one of the 'transfer'
  705.      files will cause the program to copy all the files specified within
  706.      that file to the active RAMDISK. It's kind of a 'batch' copy command!
  707.      Of course, thorough checking is done to make sure the ramdisk specified
  708.      by your file extender is active, and keep track of at least 7 other
  709.      problems that could arise, such as a file being too big for the
  710.      ramdisk. Watch the status window! With each file, the progress is
  711.      posted. Also, if you hear a bell, direct your attention to the status
  712.      box.  Probably, a file could not be copied, either due to insufficient
  713.      memory space (unlikely), or not enough RAMDISK space. If this happens,
  714.      the program will ask for a single key response to either C (continue
  715.      and try next file) or A (abort the transfer operation).  Surprisingly,
  716.      this utility will copy about 300K of files in less than 5 seconds!
  717.      When the transfer is complete, the status box will reflect the number
  718.      of files successfully copied.
  719.  
  720.           This is a good time to briefly mention the basic operation of the
  721.      ATARI ramdisk. If the ramdisk as supplied (drive G:) is in conflict
  722.      with one of your hard disk partitions, just keep this procedure in mind
  723.  
  724.                                      page 11
  725.      
  726.      
  727.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  728.  
  729.      
  730.      for later, and leave the file in it's disabled (.PR) form for now.  I
  731.      didn't include ATARI's docs here, since I found them confusing and long
  732.      winded. Actually, it's very simple. As long as you have a desktop icon
  733.      setup to access the ramdisk, all you have to do is turn your machine
  734.      on, and take one of the following actions as soon as the screen turns
  735.      white:
  736.  
  737.  
  738.           a) press '0' to deactivate the ramdisk entirely.
  739.  
  740.           b) do nothing, and the RAMDISK will configure itself to 48K
  741.  
  742.           c) press a key, from 1 to 9 depending on how many 64K blocks you
  743.              want the RAMDISK to be. If you need more than 576K, use the
  744.              alpha keys a to z. This allows up to 2048K.
  745.  
  746.  
  747.           Also note that pressing any key but '0' forces a reboot, since the
  748.      RAMDISK is configured above the screen and needs to shift memory around
  749.      quite a bit. This is why it should be one of the first programs in the
  750.      AUTO folder. If you use PINHEAD v1.8 or higher, you might even get away
  751.      with placing PINHEAD before the ramdisk. I've had some crashes doing
  752.      this, but feel free to experiment using the AUTO FILE SEQUENCE
  753.      functions. On more important thing: The ATARI ramdisk is RESET proof!
  754.      This is perfect for programmers like me that crash the system many
  755.      times during program development. Give it a try. If you don't like it,
  756.      ELF-BOOT may be run again from the desktop, so that you can use the
  757.      transfer function with a desk ACCESSORY based ramdisk.
  758.  
  759.  
  760.      7. Run Program.
  761.  
  762.           Clicking this box will first test to see if a STARTGEM.INF file is
  763.      present in your root directory. If so, it will warn you and ask if you
  764.      want to delete it. You'll normally never see this warning, since
  765.      ELF-BOOT normally deletes this file anyway, as soon as you select the
  766.      USE PROGRAM option when you begin a session. It only serves to warn you
  767.      if you mistakenly use the option twice. Now again, I'm going to
  768.      describe how this works, even though you have no STARTGEM files set up
  769.      yet. We'll see how to do this with the ELFHELP.PRG later. Assuming
  770.      there were STARTGEM files present, clicking on one of them causes it to
  771.      be copied to a newly created 'STARTGEM.INF' file. It will also enable
  772.      the STARTGEM.PRG in your auto folder. The result is that later, when
  773.      the desktop appears, that program will run automatically! STARTGEM
  774.      unfortunately does not currently run with TOS 1.4.
  775.  
  776.      8. Macro Select.
  777.  
  778.           No macros are present now, but if they were, this menu item would
  779.      be selected for you automatically when you run ELF-BOOT. A directory of
  780.      files in the ELFMACRO folder is displayed. Clicking one will cause ALL
  781.      the options of this program which you previously saved in a macro, to
  782.      be set up automatically. In addition, a macro contains a user specified
  783.      exit condition. This means that when processing is complete, the macro
  784.      can either return to or exit from the ELF-BOOT program environment.
  785.      When you click on a macro file, It's like watching ELF-BOOT run itself
  786.      at high speed.  All the menu items will select themselves, and set up
  787.      their options according to your macro specification!  However, all non-
  788.      fatal error checking is bypassed.
  789.      
  790.                                      page 12
  791.      
  792.      
  793.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  794.  
  795.      
  796.      Instead, a MACRO ERROR STATISTICS box (example below) will be displayed
  797.      after the macro is processed.
  798.  
  799.  
  800.                PROCESS NAME       FILE REQUESTS     FILES COMPLETE
  801.                ---------------------------------------------------
  802.                   AUTO PRGS:           8                  8
  803.                 ASSIGN FILE:           1                  1
  804.                 DESKTOP.INF:          --- PROCESS FAILURE ---
  805.                 ACCESSORIES:           6                  6
  806.                    TRANSFER:           4                  3 *
  807.                    STARTGEM:           0                  0
  808.  
  809.  
  810.           In this example, 8 AUTO programs specified in the users' macro
  811.      have been activated and are now ".PRG". All others have been
  812.      deactivated. An ASSIGN file has been specified and copied as well. The
  813.      DESKTOP.INF function failed however. Perhaps the file specified in this
  814.      macro was intended for a mono monitor, while the user is currently in
  815.      color mode. Six requested desk ACCESSORIES have also been enabled,
  816.      while all others have been disabled. The TRANSFER function was able to
  817.      copy only 3 out of the 4 files specified by the user, so this
  818.      discrepancy is flagged by a '*' character. No program has been
  819.      specified to run under STARTGEM, and so "0"s are displayed.
  820.  
  821.           In the event such errors occur, any exit condition specified by
  822.      the user is cancelled, and the next mouse click will return the USER to
  823.      ELF-BOOT. If you so desire, you can try to manually retry the failed
  824.      operation. In normal (or "manual") mode, the error messages are much
  825.      more extensive, and will provide full details on the nature of the
  826.      problem. If no errors occurred, and the user specified an exit
  827.      condition when the macro was created, ELF-BOOT will post a final
  828.      'good-bye' message, and exit.
  829.  
  830.      9.1 MACRO RECORD.
  831.  
  832.           While TRANSFER and STARTGEM files must be prepared outside the
  833.      ELF-BOOT environment with the ELFHELP.PRG, this is not the case with
  834.      macros. All you have to do is set up your system the way you want it
  835.      for a given application, and click the RECORD button. Again, the system
  836.      will scan all the menu items, this time recording all your selections.
  837.      For each, the status window reflects the users choices, but these
  838.      messages normally are too fast to actually read. ELF-BOOT will then
  839.      prompt you to select an exit condition for the macro. Basically, You'll
  840.      either exit the program when the macro is used, or simply return to the
  841.      ELF-BOOT environment. The normal exit condition is EXIT WITH AUTOCOLOR,
  842.      as this option replaces the color functions of the ATARI CONTROL panel.
  843.      Note again that this choice does NOT cause the exit to occur now.
  844.      Rather, it specifies what will occur when the macro is actually used.
  845.      After this selection, a directory of macro files is displayed, and ELF-
  846.      BOOT will prompt you for a filename. Pressing return with no entry
  847.      aborts the process, while an actual filename entry will cause a save.
  848.  
  849.           On problem that can arise when creating several macros in
  850.      succession, is that you must remember to specifically select every menu
  851.      item that you want changed. For example, if you create a macro that
  852.      (among other things) runs a program, and then proceed to create another
  853.      macro that should NOT run a program, you must remember to select the
  854.      RUN PROGRAM box, even though you don't intend to select anything.
  855.      
  856.                                      page 13
  857.      
  858.      
  859.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  860.  
  861.      
  862.      In other words, selecting the box automatically clears the 'macro
  863.      memory' of the last selection. This is also true of ramdisk TRANSFERs,
  864.      ASSIGN file selections, and DESKTOP file choices. So, when preparing 
  865.      multiple macros, make sure to select ALL menu items, including the ones
  866.      for which you don't pick a file.
  867.  
  868.           Another problem that arises when recording multiple macros is that
  869.      the system is unaware that you really don't want any actions to occur,
  870.      and that you're only preparing to do a macro save. So, to suspend all
  871.      file saving while setting up for a macro, click the FILE PROTECT box at
  872.      the bottom of the screen so that is highlighted. From here on, all
  873.      ASSIGN, PROGRAM RUN, TRANSFER, and automatic DESKTOP saves are
  874.      suspended, until the file protect box is turned off. With FILE PROTECT
  875.      on, file selection causes the associated file (or multiple files in the
  876.      case of TRANSFERs) to be loaded, so that basic error checking can
  877.      occur. However, instead of proceeding to copy the file(s) as usual, the
  878.      message "Selection Noted, No action Taken" will appear in the status
  879.      window. Selecting the FILE PROTECT option before making any macros will
  880.      also help to eliminate some of the  "OVERWRITE (YES/NO) and "DELETE
  881.      (YES/NO)" messages, that can be very distracting. Incidentally, the
  882.      FILE PROTECT box has NO effect when actually EXECUTING (selecting) a
  883.      macro.
  884.  
  885.  
  886.      I.V. MISCELLANEOUS functions:
  887.  
  888.      About Program.
  889.  
  890.           If you click the box in the upper right hand corner of the screen
  891.           a short commercial message for ELF-BOOT will appear.  Click the
  892.           mouse anywhere to escape this message. Note that the Demo and
  893.           Registered copies of the program contain different information. If
  894.           you have a registered copy of ELF-BOOT, be sure to check this out!
  895.  
  896.  
  897.      V. EXIT OPTIONS:
  898.  
  899.       1. Exit on Startup
  900.  
  901.           As we saw earlier, when ELF-BOOT starts up, you have the choice of
  902.           exiting immediately, or using the program. The default is to exit
  903.           with AUTOCOLOR enabled, and this option will occur after 10
  904.           seconds if the user does not intervene. We'll discuss AUTOCOLOR
  905.           more in a moment. For now, the important thing to realize is that
  906.           exiting at this point will allow you to enter the ST environment
  907.           with the same conditions that existed last time you turned your
  908.           machine on. That is:
  909.  
  910.                a. All auto programs and accessories will be the same.
  911.  
  912.                b. ASSIGN files last activated will still be active
  913.  
  914.                c. The last used desktop.inf file will remain active, unless 
  915.                   you've switched monitors. In that case, the default files
  916.                   DESKTOP.H or DESKTOP.M will be used as required.
  917.  
  918.                d. Any program set to run under STARTGEM will run again,
  919.                   since ELFBOOT does not disable this unless 'USE ELFBOOT'
  920.                   was selected.
  921.      
  922.                                      page 14
  923.  
  924.           
  925.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  926.  
  927.      
  928.      Note: Under the current version, ramdisk transfers will not occur
  929.      automatically when the EXIT option is chosen.
  930.  
  931.  
  932.      2. Manual Exit:
  933.  
  934.      When you click the EXIT box at the upper right of the screen, 3 options
  935.      will appear:
  936.  
  937.           option 1: exit without autocolor
  938.  
  939.           Normally, you'll rarely use this box, since AUTOCOLOR, once
  940.           installed, can be turned off and on again at will. It is used
  941.           primarily when You have found that for some reason, Autocolor is
  942.           absolutely incompatible with a program you intend to run (I have
  943.           found none so far). Also, an exit without AUTOCOLOR will restore
  944.           whatever colors were in place BEFORE the program was run. So, if
  945.           you exit with option 1 when the program is run from an AUTO
  946.           folder during bootup, Your Desktop colors will never be installed
  947.           (Unless you re-enable the ATARI CONTROL.ACC).
  948.  
  949.  
  950.           option 3:  coldstart
  951.  
  952.           We'll come back to option 2 in a second. Exit option 3 will
  953.           cause a re-boot. This is an full coldstart, and is much more
  954.           thorough than pressing your RESET button. Some possible uses are:
  955.  
  956.                1. When you've re-sequenced your AUTO folder programs, and
  957.                   now want to reboot with the new configuration.
  958.  
  959.                2. When you want to disable the ATARI ramdisk completely,
  960.                   with a '0' key-press.
  961.  
  962.                3. When a program (any program) causes a severe system crash,
  963.                   and the desktop is behaving strangely. Earlier versions of
  964.                   PINHEAD sometimes caused this to occur. A coldstart is the
  965.                   next best thing to powering down for 10 seconds, and can
  966.                   solve many problems that the RESET button alone can't
  967.                   cure.
  968.  
  969.      NOTE: While we're on the subject of RESET, note that exiting from
  970.      ELFBOOT with the RESET button is not recommended. In order to do the
  971.      simulation of a GEM mouse and event manager, many system changes are
  972.       made which will never be restored properly if RESET is pressed.
  973.  
  974.  
  975.           option 2.  Autocolor Exit:
  976.  
  977.           So what the heck is AUTOCOLOR anyway? Autocolor is a very powerful
  978.           feature of ELF-BOOT that goes beyond the ATARI control panel in
  979.           keeping your selected colors in place. Autocolor is a small piece
  980.           of program code (less than 1 k) that stays in memory after the
  981.           program ends. It can be installed only once, but enabled and 
  982.           disabled at will. Normally it is installed when the program is run
  983.           from the AUTO folder (but this does not have to be the case).
  984.           When ELF-BOOT starts up, as long as a usable DESKTOP file is found,
  985.           the program will exit WITH autocolor installed (or enabled) after
  986.           10 seconds on user inactivity.
  987.      
  988.                                      page 15
  989.  
  990.           
  991.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  992.  
  993.      
  994.      AUTOCOLOR... How it works:
  995.  
  996.           When autocolor is initiated, the program will exit with the
  997.      selected desktop colors still active. It steals the primary vertical
  998.      blank vector from the system, and monitors the video hardware and
  999.      screen 60 times a second waiting for the desktop to appear. At this
  1000.      point, it installs itself properly in the system vertical blank queue,
  1001.      intercepts the mouse data from the keyboard, and restores the primary
  1002.      vertical blank vector to it's original state.
  1003.  
  1004.      What it does:
  1005.  
  1006.           ALRIGHT...ENOUGH TECH TALK! With AUTOCOLOR installed, you'll see
  1007.      your selected colors appear when the desktop appears. From there on,
  1008.      ANY program that attempts to change the screen colors will fail to do
  1009.      so!  This is especially useful when you use a lot of programs that seem
  1010.      to insist that the programmers choice of colors is superior to the ones
  1011.      the user selected.
  1012.  
  1013.      Enabling/disabling Autocolor:
  1014.  
  1015.           Well that's all fine and well, but what happens when you run a
  1016.      program that needs to control the colors. A drawing program like DEGAS
  1017.      ELITE would be crippled without such control. In fact, Some parts of
  1018.      DEGAS ELITE will fight the AUTOCOLOR program so hard, that sometimes,
  1019.      after much screen-flickering battle, the program may actually crash!
  1020.      So, we need a way to easily enable or disable AUTOCOLOR, to really make
  1021.      it useful.
  1022.  
  1023.           I thought a lot about this, and decided that the old approach of
  1024.      pressing ALT - SHIFT- CTRL plus a key has been over used. My chances of
  1025.      coming up with a new combination that no one else has used are pretty
  1026.      bleak, and you'd probably forget the key combination anyway. So, here's
  1027.      what I did. If you want to disable AUTOCOLOR, press the RIGHT mouse
  1028.      button, and move the mouse to the left, _QUICKLY_, while still holding
  1029.      the button down! Just a quick left 'swish'. Slowly won't do it!  Once
  1030.      you do that, The current colors will still remain, but any program that
  1031.      wants to change them will be able to (including the old ATARI control
  1032.      panel if you want!). To re-enable AUTOCOLOR, press the RIGHT mouse
  1033.      button again, and this time move quickly to the RIGHT.  The desk colors
  1034.      will come back immediately. This sounds awkward, but believe me, it
  1035.      becomes quite instinctive.  You'll find that most of the time you
  1036.      discover the need to enable or disable AUTOCOLOR, your hand will
  1037.      already be on the mouse! In addition, You'll be hard pressed to find a
  1038.      program that really does anything destructive in response to quick
  1039.      mouse movements with the right button pushed. And, programs that do use
  1040.      the right button, never require any movements fast enough to trigger
  1041.      AUTOCOLOR. By the way, remembering the on-off direction is easy; just
  1042.      think: "RIGHT ON!!"
  1043.  
  1044.           Whenever you re-run ELF-BOOT, it first checks the system to see if
  1045.      autocolor has been installed. If so, it disables it (but doesn't remove
  1046.      it!). If you then exit the program and choose AUTOCOLOR exit, it senses
  1047.      that AUTOCOLOR is already resident, and simply re-enables it, rather
  1048.      than waste memory installing it again. This is why you will normally
  1049.      ALWAYS exit WITH autocolor. The one exception may be monochrome only
  1050.      users, since most mono programs accept the default 'black text over
  1051.      white background' format. Also, if while re-running ELF-BOOT you decide
  1052.      to change the screen colors (either manually, or by loading a new
  1053.      
  1054.                                      page 16
  1055.           
  1056.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1057.  
  1058.      desktop file), the new palette will be installed into AUTOCOLOR
  1059.      automatically when you exit.  This is in fact the only way to change
  1060.      the AUTOCOLOR palette. Incidentally, AUTOCOLOR is smart enough to keep
  1061.      your colors consistent and logical, even if you change resolutions from
  1062.      the desktop, or load in the wrong desktop file!
  1063.  
  1064.  
  1065.      VI. ELF-BOOT SUPPORT UTILITIES  ( "booties" )
  1066.  
  1067.  
  1068.      1.   RDSET.TTP
  1069.  
  1070.           To set up the ATARI ramdisk to a different default size or drive
  1071.      ID, copy the RDSET.TTP file and the RAMDISK.PRG file to the same
  1072.      directory. Also, make sure the ramdisk filename is exactly as described
  1073.      above. Run the RDSET program, and you'll be prompted for an input.
  1074.      RDSET requires a single alphabetic character, and a single number, with
  1075.      no spaces in between. The letter can be any drive specifier from 'D'
  1076.      through 'P'. The number can be '0' thru '9', and this sets the default
  1077.      number of 64K blocks that the ramdisk will configure to if no keypress
  1078.      occurs at boot time. For example, the RAMDISK, as received, was setup
  1079.      using RDSET by entering the parameter  "G1". This corresponds to a G:
  1080.      drive, that by default is only 64K. The program will notify you of any
  1081.      problems that occur. If all goes well, it will rename your old file to
  1082.      "RAMDISK.BAK", and prepare a new "RAMDISK.PRG" file with the new setup.
  1083.      You can re-configure the RAMDISK as often as you like. I recommend the
  1084.      64K setup, since this amount of ram is of little consequence, even if I
  1085.      don't use the ramdisk and forget to disable it. Copy the new file back
  1086.      to your AUTO folder, and Be careful not to end up with 2 files (.PR and
  1087.      .PRG)!
  1088.  
  1089.  
  1090.      2.   ELFHELP.PRG
  1091.  
  1092.           Both TRANSFER and STARTGEM files are basically text files that
  1093.      contain full path(s) to an existing file.  The only difference in fact
  1094.      between TRANSFER and STARTGEM files is that the latter may only contain
  1095.      a single path string rather than a multiple list. For ST users used to
  1096.      zipping through folders with mouse clicks, it is quite difficult
  1097.      sometimes to remember the full path of a program.  For example, my
  1098.      terminal program " FLASH" requires a path sting like this to make a
  1099.      GEMSTART file:
  1100.  
  1101.                     D:\TELECOM\FLASH\FLASH.PRG
  1102.  
  1103.           I couldn't expect the user to remember strings like this from
  1104.      within ELF-BOOT, and adding code to make the file select window into a
  1105.      full replica of the GEM file selector box was in my opinion, too much
  1106.      effort for too little gain. The solution was to provide a separate
  1107.      program which could be run from the desktop, and so provide the user
  1108.      with a real GEM file selector box, or allow him to use whatever file
  1109.      selector replacement he is used to. the ELFHELP.PRG does just that.
  1110.  
  1111.           Preparing STARTGEM files.
  1112.  
  1113.           ELFHELP.PRG is run from the desktop, and should normally reside in
  1114.      the root directory of your boot disk. It will first ask you whether you
  1115.      want to create a STARTGEM file, TRANSFER file, or EXIT the program.  If
  1116.      you choose STARTGEM, a familiar file selector box will appear. Use it
  1117.      to find the program you want ELF-BOOT to be able to run from it's 
  1118.      
  1119.      
  1120.                                      page 17
  1121.  
  1122.           
  1123.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1124.  
  1125.      
  1126.      'RUN PROGRAM' option. Click on the desired file, followed by the OK
  1127.      button. (Clicking the CANCEL button will return you to the start of the
  1128.      program). Note that the program file you choose may be imbedded in any
  1129.      combination of drive partitions and folders you choose. At this point,
  1130.      ELFHELP will store the selected path/file name in a text file in the
  1131.      STARTGEM folder.  the name of the file will be the filename you
  1132.      selected, with a ".RUN" extender. If you try to run ELFHELP from
  1133.      anything other than your boot drive, it will not be able to find the
  1134.      STARTGEM folder you prepared earlier. In that case, the file will be
  1135.      saved to the current directory. In either case, when the save is
  1136.      complete, the program will return to the initial dialog box and prompt
  1137.      you for what to do next. When preparing STARTGEM files, be careful not
  1138.      to mistakenly select a non program file. Programs on the ST all have
  1139.      an extender of ".TOS", "TTP", ".APP", or ".PRG". Note also that the
  1140.      text files produced do not have to be named the way ELFHELP names them.
  1141.      You can rename them to anything you want, so long as they stay in the
  1142.      STARTGEM folder.
  1143.  
  1144.  
  1145.           Preparing TRANSFER files.
  1146.  
  1147.           Selecting TRANSFER at the start of the ELFHELP program will again
  1148.      allow file picks via the GEM item selector box. Use this option to
  1149.      create LISTS of files that ELFBOOT will use in it's RAMDISK TRANSFER
  1150.      function. It works like this:
  1151.      
  1152.        1) Use the file selector to pick files you want to be transfered.
  1153.  
  1154.        2) After each file pick, you'll be asked if you want to add more.
  1155.  
  1156.        3) Selecting CANCEL from the item selector will simply return you to
  1157.           the above message, and will list the files picked so far.
  1158.  
  1159.        4) When you're done selecting files, you'll be prompted for a
  1160.           filename to save under, using the same file selector box. If the
  1161.           program can't find the TRANSFER folder, the file will be saved in 
  1162.           the root directory.
  1163.  
  1164.        5) With TRANSFER files, remember that the extender must match your 
  1165.           RAMDISK specifier (Ex:   MYTRANS.G  = transfer to drive 'G:').
  1166.  
  1167.  
  1168.  
  1169.      VII. ADVANCED USER NOTES:
  1170.  
  1171.           These are just some tips I've discovered, that make using ELFBOOT
  1172.      a little more logical. First, as mentioned earlier, try to get into the
  1173.      habit of using generic filenames for programs, accessories, and any
  1174.      other files that ELFBOOT must handle. This is especially true if you
  1175.      use macros and transfer files a great deal. When new versions of a
  1176.      program get installed into your system, keeping the name consistent
  1177.      will avert the need for rebuilding MACRO, TRANSFER, and STARTGEM files.
  1178.  
  1179.           It is also important to note that as text files, MACRO, STARTGEM,
  1180.      and TRANSFER files can all be hand edited with a text editor, or
  1181.      word processor capable of saving in straight ASCII format. While the
  1182.      contents of the latter two files is probably obvious by now, the macro
  1183.      files need a little more attention. 
  1184.      
  1185.  
  1186.                                           page 18
  1187.  
  1188.      
  1189.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1190.  
  1191.      
  1192.      Here is a typical macro text file:
  1193.  
  1194.                #auto:
  1195.                PINHEAD.PRG
  1196.                RAMDISK.PRG
  1197.                SUPCLKRD.PRG
  1198.                FOLDER200.PRG
  1199.                ELFBOOT.PRG
  1200.                #assign:
  1201.                #desktop:
  1202.                DESKWP.M
  1203.                #accessories:
  1204.                CALC.ACC
  1205.                MEMFILE.ACC
  1206.                PRINTDIR.ACC
  1207.                CALENDER.ACC
  1208.                #transfer:
  1209.                #startgem:
  1210.                WWRITER.RUN
  1211.                #exit:
  1212.                2
  1213.  
  1214.           Pretty straightforward really. For each macro category, an entry
  1215.      must exist even when no file is specified, as is the case with the
  1216.      "#assign:" directive above. If files are specified for the "#transfer:"
  1217.      or "#startgem:" directives, the files must be the text files prepared 
  1218.      by ELFHELP. In other words, if you try to hand edit one of these, don't
  1219.      specify FLASH.PRG (example) for a startgem file. Rather, specify the 
  1220.      name of a filename, in your STARTGEM folder, that contains the full 
  1221.      path to the FLASH program, in ASCII form. If all this sound confusing, 
  1222.      then don't worry about it. The information is just here to aid the 
  1223.      advanced user. Directly editing macro files may yeild some time savings 
  1224.      over building a new file from ELFBOOT. A good example is when a complex 
  1225.      macro needs only its' DESKTOP file changed, to accomodate a mono or 
  1226.      color monitor. The final digit in the file specifies the exit condition
  1227.      for the macro. 0 means return to program when done, and '1' and '2' 
  1228.      refer to exiting WITHOUT or WITH autocolor, respectively.
  1229.  
  1230.       
  1231.           As you become familiar with the system, you'll ultimately think of
  1232.      many ways in which the program could be made even more powerful.
  1233.      Several ideas have come to my mind already. (Not bad for a version 1
  1234.      though ehh?).  Please feel free to send comments and suggestions either
  1235.      by mail, via COMPUSERVE (EMAIL only to 73637,317), GEnie (ATARI 
  1236.      roundtable, or GE Mail address: R.CONSTAN),or THE NEST, which is the 
  1237.      official BBS of the Long Island Atari User Group. Their number is 
  1238.      516-234-4943. Let me state however that what I'm most interested in 
  1239.      is enhancements to make the program more useful, rather then just 
  1240.      longer!  (I'll never make it play music or draw pictures for example).
  1241.      Also, I'd like to know of any and all incompatibilities with other 
  1242.      programs you discover. Unfortunately, I did not find out until the very
  1243.      last minute that STARTGEM does not work with TOS 1.4. I will try to
  1244.      find a way around this as soon as possible, and again Registered users 
  1245.      will find out via direct mailing, whenever new ELF-BOOT versions or
  1246.      information becomes available. So finally, one last time: If you like 
  1247.      the program, please register. And, if you're part of a user group, 
  1248.      take $5 off the registration fee (per unit!) when you order 5 or more 
  1249.      copies at a time. This is my way of saying Thanks for not pirating.
  1250.      
  1251.  
  1252.                                      page 19
  1253.  
  1254.      
  1255.           
  1256.          ELF-BOOT!  by Randy Constan,   Elfin Magic Software    (c)1991
  1257.  
  1258.      
  1259.           Before ELF-BOOT could be written, it was necessary to create a few 
  1260.      special code modules to simulate the GEM interface. Some of these may be 
  1261.      of interest to other developers. While I havn't finalized a licencing 
  1262.      fee for these modules, I can say that they will be very reasonable 
  1263.      provided that proper credit is given in the docs of the resulting 
  1264.      products. Here are some of the more interesting source codes available:
  1265.      
  1266.      AUXMOUSE.S   This module creates a completely stand alone mouse cursor, 
  1267.      that exactly duplicates the GEM mouse function. It installs cleanly in 
  1268.      the VBI, and may be removed at any time. It may be passed a list of 
  1269.      rectangles, and will return the Rectangle number and button data in 
  1270.      response to a mouse click. The rectangle list may be changed at any 
  1271.      time, to allow for secondary graphic inputs, such as simulated alert 
  1272.      boxes. Because of it's independence, it can run equally from an 
  1273.      AUTO.PRG, or under GEM. It also provides for the possibility of changing 
  1274.      the cursor form, with standard mouse data, mouse mask, and hotspot data. 
  1275.      All 3 standard resolutions are supported.
  1276.      
  1277.      FONT6X6   This is a standalone utility for printing 6x6 system fonts, 
  1278.      but only ascii codes from 1 to 127 are included. You pass it position 
  1279.      and color data, and a pointer to a standard (zero terminated) string. 
  1280.      Options are included to control both foreground and background color, as 
  1281.      well as X-RAY or BLOCKED mode. Again, this runs with or without GEM 
  1282.      surfaces, in all 3 resolutions.
  1283.      
  1284.      DRAWFILL.S This is actually a high performance graphic package which was 
  1285.      originally intended for an ST version of SUPER 3D PLOTTER (something 
  1286.      only 8 bitters would remember). Anyway, It can draw lines, draw filled 
  1287.      or unfilled boxes (with borders), and fill convex polygons with any 
  1288.      number of sides. Line clipping is also built in, allowing the user to 
  1289.      specify points anywhere in a + or - 32K range. The fill commands allow 
  1290.      16 dithered patterns in monochrome and med res., as well as the standard 
  1291.      16 colors of lo rez. As a line engine, it exceeds 1000 lines/second in 
  1292.      random line draw tests.
  1293.      
  1294.      ALERT.S   Actually, this code is somewhat imbedded in the ELF-BOOT code, 
  1295.      but I can extract it if someone is interested. It allows all the alert 
  1296.      box actions in ELF-BOOT, and could easily be modified to allow a default 
  1297.      RETURN keypress button. It's much less cumbersome than the GEM alert 
  1298.      box, and allows much more variation in size, text size, and text color. 
  1299.      Of course, the 6x6 font code is needed if the alert boxes are to contain 
  1300.      the small system font.
  1301.      
  1302.           I would also like to hear from other developers, so that we can 
  1303.      work together to insure that ELF-BOOT gets along well with, and maybe 
  1304.      even enhances other applications. There are many startup utilities out 
  1305.      there. ELF-BOOT, though it's macros, may for the first time allow the 
  1306.      user to select any startup program or desktop replacement, at boot time! 
  1307.      For example, the ramdisk transfer can be used to copy files not only to 
  1308.      a ramdisk, but to any active drive. By carefully combining this utility 
  1309.      with the other setup function, a macro could be created to setup for 
  1310.      NEO-DESK(TM), HOTWIRE(TM), or a host of other packages. The program is 
  1311.      very open ended, and I am open to changes to make ELF-BOOT support other 
  1312.      products.
  1313.      
  1314.           Finally, I wish to thank Steven Stubbs and John Aalto of the Long 
  1315.      Island ATARI user group. You have these relentless beta testers to thank 
  1316.      for beating the program bug free, and gently forcing me to add many 
  1317.      important features to ELF-BOOT. Enjoy the program!
  1318.  
  1319.                                      page 20
  1320.  
  1321.